home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / util / misc / RunLame.lha / RunLame1.28 / runlame.lha / RunLame / Docs / RunLame_V1.28.doc < prev    next >
Text File  |  1993-08-25  |  37KB  |  788 lines
  1. ____________________________________________________________________________
  2.  
  3. $VER: RunLame V 1.28 documentation (© by Bilbo the first of Hypenosis on 25.08.93)
  4. ____________________________________________________________________________
  5.  
  6.  
  7.                                   RunLame
  8.                                   =======
  9.  
  10.                    Copyright 1992-1993 by Bilbo the first
  11.  
  12.  
  13. Accept this or delete the complete package now:
  14. ----------------------------------------------
  15.  
  16. This  software  is NOT in the Public Domain, NOT Freeware and NOT Shareware.
  17. There  are  NO  warranties, either expressed or implied, with respect to the
  18. software,  its  quality,  performance,  merchantability,  or fitness for any
  19. particular  purpose.   This software is provided "as is" and the entire risk
  20. as  to  its  quality  and  performance is with the user.  The author of this
  21. software  shall  NOT  be  liable for errors contained in the software or the
  22. software's  documentation, or for incidental or consequential damages of any
  23. kind  in connection with the performance, use or posession of this software.
  24. The  use  of  undocumented  features/commands  is  not permitted except with
  25. permission  from  the  author,  and  the author is in NO way responsible for
  26. consequences thereof.  Anyone may use it for private purposes, and it may be
  27. given  away  for  free,  as  long  as  it  is NOT part of any deal involving
  28. purchases;  and  fees for copying and/or distribution, and/or fees for disks
  29. exceeding   the   actual  market  price  for  an  empty  disk  of  the  same
  30. brand/quality  is  to  be  considered  as  commercial  exploitation  of this
  31. software,  and  an  infringement  of  the Copyrights (©) of the author.  The
  32. right to use this software and/or its documentation for private purposes may
  33. or  may  NOT  be  restricted  by  additional  copyrights and/or registration
  34. conditions.   If  given away under above (or below) conditions, the receiver
  35. in  NO  way  receives  the  ownership of the program itself, but may only be
  36. licenced  to  use  it if above and below conditions are met.  If these rules
  37. infringes   the   local   law  and/or  rights  of  any  area,  political  or
  38. geographical,  this  software  is NOT to be used and/or distributed in these
  39. areas.
  40.  
  41. For  further license and terms for software originating from Bilbo the first
  42. consult the file Copyright.notice which came with this package.
  43.  
  44. This package is PrayWare, please read the file PrawWare.license.
  45.  
  46.  
  47. Table of contents:
  48. -----------------
  49.  
  50.                             The aim of the game
  51.                                   Features
  52.                                 The bad news
  53.                              How to use RunLame
  54.                             Configuring RunLame
  55.                        Problems - solutions - corner
  56.                                  Known bugs
  57.                                 Future plans
  58.                                   History
  59.                              Thanks, greetings
  60.  
  61.  
  62. The aim of the game:
  63. -------------------
  64.  
  65. Do  you  run  your  system  using  another  screenmode than PAL or NTSC, for
  66. example  EURO72 or an AGA specific screenmode?  Have you ever tried to start
  67. a  game or demo from within this screenmode?  Have you ever been angry about
  68. those  programmers  who  do  not stick to the guidelines of programming thus
  69. producing  programs  which are not aware of the screenmode they were started
  70. out of?
  71.  
  72. Do  you  have an Amiga with 68010, 68020, 68030 or 68040 processor?  Did you
  73. ever curse those socalled coders whose programs crash your computer when you
  74. didn't  disable  the  processor's  caches and forgot to move the vector base
  75. register back to $0.l?
  76.  
  77. Lame programming is the disease, RunLame is the cure!
  78.  
  79. RunLame is a Kick2.04+ tool, it will NOT work under Kick1.0/1.1/1.2/1.3/1.4!
  80. RunLame  is  100% reentrant Assembler code, so you can set the pure flag and
  81. make it resident. RunLame is startable from Workbench.
  82.  
  83. RunLame considers some adjustments and a command line and executes the given
  84. command  line, just after having degraded the display (optional) and the CPU
  85. (optional).   When  the  command  line has been executed the display and CPU
  86. state is restored to the same as before executing the command line.
  87.  
  88. Summarizing  we  can say RunLame is a multitasking friendly temporary system
  89. degrader  which  may  let  some  bad  behaving programs run in your system's
  90. environment  (but  can't  give  any  guarantee).   If  some  of those `lame'
  91. programs  don't  run  though  RunLame  has  been  used, they are on a higher
  92. lameness-level,  which  can't  be fixed by RunLame (this is definitely not a
  93. bug of RunLame).
  94.  
  95. I do write demos myself and you can believe, I DO KNOW how to write a proper
  96. startup code.  Consider RunLame beeing an external startup code.
  97.  
  98.  
  99. Features:
  100. --------
  101.  
  102. The {}'s inform you about the needed system configuration for a feature.
  103.  
  104.  ·Optionally disabling of each processor cache, burst or copyback mode.
  105.   {68020, 68030[EC], 68040[EC]}
  106.  
  107.  ·Optionally  moving  vector base register (VBR) to location $0 or to a FAST
  108.   memory location.
  109.   {68010, 68020, 68030[EC], 68040[EC]}
  110.  
  111.  ·Optionally  degrading  display's screenmode to simulate old chipset (OCS).
  112.   This can optionally preserve or hide the current display contents.
  113.   {ECS, AGA}
  114.  
  115.  ·Degrading  sprite  resolution to simulate old chipset if display degrading
  116.   is activated.
  117.   {AGA}
  118.  
  119.  ·Turning  off  sprites  in a system friendly manner if display degrading is
  120.   activated.
  121.   {OCS, ECS, AGA}
  122.  
  123.  ·Flexible fix for many lame programs.
  124.  
  125.  ·Works under Kickstarts 2.04, 3.0 and 3.1.
  126.  
  127.  ·Due  to  100% system conform and system friendly algorithms, future system
  128.   compatibility  is  as  high  as  possible.   Furthermore  the multitasking
  129.   environment  is not hurt or damaged by the code.  All degrading is done as
  130.   smart as possible, and the code did never crash during beta testing.
  131.  
  132.  ·verified,  tested  and  safe  (100%  assembler)  code  resulted in a short
  133.   binary.
  134.  
  135.  ·Impressive user friendlyness due to various possibilities of usage:
  136.  
  137.    ·A CLI/Shell interface with online help and OS2 conform parsing for quick
  138.     and  effective  usage  directly,  or  indirectly  (fi.   aliases,  shell
  139.     scripts, DirectoryOpus calls).
  140.  
  141.    ·Startable  from  Workbench,  additionally  a whole bunch of tooltypes is
  142.     supported.
  143.  
  144.    ·A  GUI in gadtools style of OS2+ for maximum convenience.  Supports pull
  145.     down  menus,  keyboard shortcuts, ASL filerequesters (which of course is
  146.     the  most  patched  system  part  :-), an application window wich can be
  147.     zoomed.
  148.  
  149.    ·An  application  icon which can be placed on the Workbench for intuitive
  150.     and specialized usage.
  151.  
  152.  ·Detailed  messages  inform  the  user in failure situations.  Messages are
  153.   automatically  directed  to  Shell  window  or to requesters, depending on
  154.   operation mode.
  155.  
  156.  ·Output   of  the  commandline  is  directed  to  Shell  window  or  to  an
  157.   automagically opening window , depending on operation mode.
  158.  
  159. Sounds great?  YAH - Yet another hype?  Hypenosis - Better believe the hype!
  160. But keep on reading, here comes...
  161.  
  162.  
  163. The bad news:
  164. ------------
  165.  
  166.  ·The GUI is not font adaptive, nor is it localizable.
  167.  
  168.  ·Though  the  code  worked  very  well during the beta testing phase, there
  169.   might be nasty bugs.
  170.  
  171.  ·RunLame  can't be used to run non-DOS trackloading demos, for I don't want
  172.   to  support  this kind of loaders.  I usally like to keep good demos on my
  173.   harddisk, which is not directly possible with `trackmos'.  So I don't keep
  174.   lame coded `trackmos'.
  175.  
  176.  ·The icon of RunLame is not yet very original.  If you would like to draw a
  177.   better one, which i shall distribute in the next release, contact me.
  178.  
  179.  ·The documentation often might use improper terms.  Please excuse this, for
  180.   I  am  not  a  native  english  speaker.   If  you  want  to  improve  the
  181.   documentation, please contact me.
  182.  
  183.  
  184. How to use RunLame:
  185. ------------------
  186.  
  187. Workbench tooltypes and appropriate CLI option (see CLI options explanation):
  188.  
  189. COMMANDLINE=any valid commandline  : COMMANDLINE
  190. GFXUSERINTERFACE=USE               : GFXUSERINTERFACE
  191. APPICON=USE|OFF                    : APPICON
  192. LOOP=YES|NO                        : LOOP
  193. DEFAULTS=USE